home *** CD-ROM | disk | FTP | other *** search
/ Turnbull China Bikeride / Turnbull China Bikeride - Disc 2.iso / STUTTGART / EDITORS / RISCFORM / !FormEd / !Updates < prev    next >
Text File  |  1991-06-24  |  25KB  |  443 lines
  1.  
  2. *****************************************************************************
  3.  
  4.             FormEd 2.87  -  by Acorn Computers and the RISC squad
  5.  
  6.                            with RISC Squad commentary
  7.  
  8. *****************************************************************************
  9.  
  10.                             Version 2.80 - 21/09/90
  11.  
  12. Completed 21st September 1990 to version 2.80. Here's a list of all the
  13. things I did, as far as I can remember - I didn't make a list as I went
  14. along.
  15.  
  16.         i) Icons can now be selected/deselected by clicking the menu button
  17.                on them whilst holding the SHIFT key down.
  18.        ii) The icon dragging procedure - with the left button - now moves
  19.                all of the selected icons in the window.  Dragging with the
  20.                right button (re-sizing) is unchanged.
  21.       iii) The main menu structure has been split into an Icon menu and a
  22.                Window menu - for convenience and for speed.  Previous
  23.                releases of FormEd were notoriously slow at creating their
  24.                menus. Each of the two menus includes an option for calling
  25.                up the other, which will then be opened as default on each
  26.                subsequent occasion.
  27.        iv) The Window menu is largely unaltered, but does include a 'save'
  28.                option for saving only one template at a time. Be warned,
  29.                font freaks - the save routine will check for anti-aliased
  30.                fonts in all other windows too, so I don't know what will
  31.                happen in that situation. Whatever it is, it shouldn't be
  32.                fatal.
  33.         v) The Icons menu is now far more versatile than before.  Many
  34.                choices are now available for all selected icons (in that
  35.                window only) including specific choices from the EDIT ICONS
  36.                submenu structure - notably BUTTON TYPE !!
  37.        vi) The RENUMBER option is virtually as before, but the renumbering
  38.                process can be optimised by the use of the MENU button whilst
  39.                depressing the CONTROL key. This is identical to choosing the
  40.                'Renumber #nn' option directly.
  41.       vii) The DESELECT ALL option deselects all the icons in the current
  42.                window.
  43.      viii) The COPY and MOVE choices may now be performed on either single
  44.                icons or on all the selected icons.
  45.        ix) The WIPE option may now be on selected icons, on a single icon or
  46.                on any icon number specified. I find this useful in two
  47.                instances - (i) When I import templates which have 'missing'
  48.                icons that aren't used - see Paint's 'save' box, icon #1 is
  49.                to the right and is '<CRAP>'  (ii) If I can't find one of my
  50.                own icons !!
  51.         x) Note that any options which are either on 'selected' icons or on
  52.                a specific icon can be controlled by clicking MENU over a
  53.                specific icon for the latter, or on no icons (the window's
  54.                work area) for the former. In such a case, if no icons are
  55.                selected, you will be informed, eg. 'Wipe No Icons' - which
  56.                will also be 'shaded out'.
  57.  
  58.   All in all, the lesson to be learned from this is - if you want any icons
  59. to be selected (in the finished template) - leave them to the end, so they
  60. don't screw up your work !
  61.  
  62. PS   I also put in an 'Info' box and attached it to the icon bar menu as
  63.      expected. Plus, while checking up on the 'Save one template' job I
  64.      re-enabled the facility to save off the entire file merely by choosing
  65.      the 'Save templates' option on the icon bar menu. - this had been
  66.      REMd out !
  67.  
  68. *****************************************************************************
  69.  
  70.                     Updates, Version 2.81 - 24/11/90
  71.  
  72.   The main problem bugging those people I knew of who were using this was
  73. that of the un-named windows not being saved. I have therefore included a
  74. new error in the 'save' routine such that the error 'Only the named windows
  75. were saved' occurs if any of the templates were un-named.
  76.   I also fixed the 'Move Selected' option from the 'Icons' menu, which did
  77. absolutely nothing in version 2.80.
  78.  
  79. *****************************************************************************
  80.  
  81.                     Updates, Version 2.82 - 02/12/90
  82.  
  83.   Oops, version 2.81 was chronically buggered ! The aforementioned error
  84. occurred on every occasion, without exception. This is now completely
  85. fixed ! The extra features are as follows :
  86.  
  87.         i) It is now impossible to create un-named templates.
  88.        ii) The identifiers of windows must be different on a non
  89.                case-sensitive basis, i.e. It is not now possible to call one
  90.                template 'Save' and a different template 'save' even though
  91.                the names, strictly speaking, are distinct.
  92.       iii) Clicking on the icon bar icon opens a dialogue box, prompting the
  93.                user to enter the identifier of the new template. Press ENTER
  94.                or click on OK to confirm; press ESCAPE or close the box to
  95.                cancel.
  96.        iv) Alternatively, a new template may still be created by the use of
  97.                the icon bar menu structure. The normal rules for identifiers
  98.                still apply.
  99.         v) Any new template has its title bar icon set to text as before,
  100.                but the text defaults to the identifier at the time of
  101.                creation. This allows easy reference on a set of newly
  102.                created templates.
  103.        vi) As a result of all this, the errors such as 'Only named windows
  104.                can be saved' and 'Only the named windows were saved' are now
  105.                a thing of the past !
  106.       vii) On a completely different point : newly created icons now appear
  107.                directly underneath the pointer rather than a small distance
  108.                above it.
  109.  
  110. *****************************************************************************
  111.  
  112.                     Updates, Version 2.83 - 23/12/90
  113.  
  114.   Aha, welcome back to all template designers. It's been exactly three weeks
  115. since v2.82 and in such a short time I found a lot to do to the program, it
  116. wan't hard. Have you noticed how all of these have been issued at weekends,
  117. i.e. Friday, Saturday, then Sunday twice ?
  118.   I suppose I should tell you what I've done to it again - well, in order of
  119. appearance...
  120.  
  121.         i) The icon bar menu is restructured so that the templates and the
  122.                sprites are handled independently. This also makes the main
  123.                menu less tall, which looked very silly.
  124.        ii) You will of course have noticed an unfamiliar option on this menu
  125.                as soon as you tried it out after you'd read through part (i)
  126.                i.e. the new 'Clear' option. Fairly self-explanatory, all it
  127.                does is asks for confirmation, then clears all templates from
  128.                memory. This is mainly useful for loading a new file etc.
  129.            For example, if you want to pinch the save box from Edit, then
  130.                you would load the templates from Edit, save off just the one
  131.                template you wanted, clear the templates then re-load the old
  132.                file, eg from RAM:. This saves either (a) deleting all of the
  133.                templates in the file 'by hand' or (b) quitting FormEd and
  134.                waiting for another copy to load and initialise (very slow)!
  135.       iii) The next idea I had was to add a facility for certain 'default'
  136.                icons, rather than the <Untitled> icon as before. This became
  137.                a thorough restructure of the icons menu, to become a more
  138.                filer-type menu tree. Here's how the new 'icons' menu looks.
  139.        iv) Create icon - On its own, this creates the old <Untitled> icon,
  140.                almost. The submenu has a variety of goodies on offer ;
  141.                Text      - Colour 12 bordered text icon   (Click/Drag)
  142.                Sprite    - 'Free-standing' sprite icon    (Click/Drag)
  143.                Arrow     - Colour 12 bordered arrow icon  (Click/Drag)
  144.                Option    - Normal 'Optoff,Opton' icon     (Radio)
  145.                Radio     - Normal 'Radiooff,Radioon' icon (Radio)
  146.                Writeable - Normal text entry icon         (Write/Click/Drag)
  147.                Menu      - Normal menu icon, eg 'OK' box  (Menu)
  148.                Comment   - 'Free-standing' text icon      (Click/Drag)
  149.                             e.g. the 'Name:' icon in a
  150.                                  ProgInfo window.
  151.  
  152.         v) This is where the similarities to the Filer start. The third
  153.                choice is either 'No Icons' or 'Selected Icons' or 'Icon #0'
  154.                for example. The submenu yields to present the choices :
  155.                Edit, Copy, Move, Wipe, and Renumber - all as in v2.82
  156.        vi) By the way, the 'Button type' menu has been rigged to disallow
  157.                types 12 & 13 (reserved) and type 11 is once again referred
  158.                to as 'Radio'
  159.       vii) Back to the filer, the next two choices are 'Select All' and
  160.                'Deselect All'
  161.      viii) Lastly, 'Tidy Icons' removes any spurious icons that lie wholly
  162.                outside the window's Work Area. Note that this is NOT the
  163.                same as outside the opened window space. For example, in
  164.                Paint's notorious SaveBox [see v2.80, (ix),(i)] the CRAP icon
  165.                is within the Work Area, but the lack of scroll bars on these
  166.                windows sometimes makes it seem to lie beyond these bounds.
  167.  
  168.    NB when using the default icons on the 'Create' submenu, make sure that
  169.       you remember to set the button types of the icons, particularly the
  170.       arrow icons (usually Auto-Repeat). The icons default to Click/Drag
  171.       because they rarely appear in exactly the right place, so need moving.
  172.  
  173.                               Happy templating ! !
  174.  
  175. *****************************************************************************
  176.  
  177.                     Updates, Version 2.84 - 07/02/91
  178.  
  179.   Thought for the day :
  180.   When I use this - and I do, despite the bugs - I nearly always use the
  181. icons menu rather than the windows menu, but this poses an annoying problem.
  182. How does a lazy programmer (contradiction ?) like me delete a window without
  183. using the other menu ? Answer - put the 'Delete window' choice on BOTH.
  184. Completely against the idea of separating the two menus, but I don't care.
  185.   I was quite stunned when I happened to notice how Acorn handled their icon
  186. indirection workspace - it goes like this. (i) DIM a large block of memory.
  187. (ii) Set a pointer to the start of this area. (iii) Whenever workspace is
  188. needed, use the memory at the pointer, and move the pointer on. (iv) When
  189. the pointer reaches the end of the buffer, annoy the user by generating
  190. errors. Actually, (iv) might have been 'by crashing without explanation' -
  191. but if it was, I've already 'corrected' this.
  192.   To counteract this problem, the pointer is moved back to the beginning
  193. when the last template is deleted, or if 'Clear' is chosen from the icon bar
  194. menu. Crude, but still better than Acorn.
  195.   I've been hassled a lot recently by my friend Anonymous 'Rabbit' (Unknown)
  196. 'cos he was getting worked up about the indirection buggy bits - apparently,
  197. when large, multi-indirected templates are used (waffle) the indirection
  198. buggers up so the icons start to contain bits of the !RunImage, i.e. it
  199. points to the WRONG BIT of application workspace. As a result, when you wipe
  200. it, bits of your (still running) program go missing, and crashes ensue.
  201.   Alternatively, all the icons are inter-connected, so when you delete the
  202. unwanted bit of one, the other one does spurious things too.
  203.   I think I've sussed it though; I looked at the code, changed a few things
  204. and now it seems to work, so to quote the ISV docs, 'Everyone is happy'.
  205.   Rabbit was also whining about the way that the files were saved
  206. 'backwards' so that the window stacking is reversed. Big template files have
  207. to be kept tidy in this respect, it was annoying !
  208.   I've just done another detail - when a single template was saved before,
  209. the 'Original' filename, as appears off the icon bar 'save' box, was changed
  210. to become that of the single template just saved. It was wrong, it's not
  211. now.
  212.   The other (trivial) bug was that the colours menus did odd things;
  213. sometimes the icon colours menu was in monochrome, and always there were
  214. problems with mobile tick on the currently selected colour - particularly if
  215. a menu choice was made with ADJUST. This is fixed too. Acorn were previously
  216. reading the palette each time the tick moved, to decide which colours
  217. contrasted with which others - this is now, of course, done on the WIMP
  218. message which has something to do with palette changes, and it's faster too.
  219.   Typical.
  220.  
  221. *****************************************************************************
  222.  
  223.                     Updates, Version 2.84b  - 01/03/91
  224.  
  225.   Nothing fascinating, as usual - a minor bug fix to do with the
  226. 'Icon #nn.Edit.Text' bit of a submenu, from where the text sometimes goes
  227. walkies. The usual un-recreatable bug sort of idea, the icon would contain
  228. text, but the menu would suggest that it had a null text string.
  229.   Also I added a new choice to the icon bar menu, 'Finish', which is exactly
  230. equivalent to 'Save Templates' then 'Clear Templates'. Some choices, i.e.
  231. 'Finish', 'Clear' and 'Save' are now shaded whenever there are no templates
  232. loaded into FormEd.
  233.   I thought it would be a nice idea to be able to load an application's
  234. 'Templates' file by merely dragging the application to FormEd, so it now
  235. attempts to load the file '!ApplName.Templates', failing if it is not found,
  236. or if it does not have the file type &FEC (Templates). I was right about the
  237. nice idea, it's very convenient ! The slight fib is that the normal error
  238. 'This application has no Templates file' occurs even if it exists, but with
  239. the wrong file type. So who cares anyway ? Not my problem.
  240.   Lastly, the general icons menu now opens such that the pointer is usually
  241. over the 'Selected icons' jobbie, making editing slightly easier, ta very
  242. much Mister WIMP, see you on the next version of FormEd.
  243.  
  244. *****************************************************************************
  245.  
  246.                     Updates, Version 2.85 - 15/04/91
  247.  
  248.   Back for more, masochist ? Even our goody-goody programmer who can't do a
  249. thing wrong otherwise Acorn will slap him on the wrist has taken a copy of
  250. 2.84b-and-a-bit because he got fed up with v1.something by Acorn shite co..
  251.   By the way, those who know me - PLEASE - when you find a bug in this, don't
  252. just complain - TELL ME WHAT THE *?#!^& BUG IS !!!! That way I can debug it
  253. faster, n'est-ce pas ?
  254.   Anyway; I don't like 12-long sprite names, or 12-long text entries for that
  255. matter, when they're not indirected. I've just ironed out some bugs; for
  256. example, I decided I'd had enough of not seeing save icons in xfer_send
  257. windows (ie when the sprite name is indirected) so I took out that 'feature';
  258. so now you can see them, whoopee, hurrah.
  259.   I'm not sure exactly what was going on in the way of sprite-area handling
  260. (ie whether sprites are USER or WIMP) but the load and save bits now trap it
  261. all neatly (see the xfer_send job) and the WIMP area is always assumed.
  262.   If you get an error (ie of the type with an error box and a line number) be
  263. careful no to choose 'Cancel' as this now quits FormEd without saving off.
  264.   Those of you (ie most) who've played with v2.85 may have noticed one or two
  265. bigger changes :
  266.  
  267.         i) I took out the crappy sprite editing bits, leaving in just rename,
  268.                copy, delete, load, merge and save. Note now that your own
  269.                sprite files can be merged by SHIFT-dragging to the icon bar;
  270.                if this worked, and the 'Sprites' window was NOT open, then a
  271.                'beep' tells you that it worked. (Actually, any FormEd window
  272.                that isn't the 'Sprites' one will do.)
  273.        ii) Select and Deselect icon (from the general icon menu) now have
  274.                sub-wotsit-jobbies. (I suppose I should know their real names,
  275.                having just read the new 'RISC-OS Style Guide', then wondering
  276.                why I bothered).
  277.       iii) Choosing [De]Select as normal has the same effect as before.
  278.        iv) The dialogue boxes enable choices to be made governing which icons
  279.                are (de)selected; any other icons are absolutely unaffected.
  280.                Icons of a particular (or 'any') ESG can be chosen.
  281.                Icons of a particular (or 'any') Button Type can be chosen.
  282.                An icon's TEXT bit can be tested (yes/no/don't care).
  283.                An icon's SPRITE bit can be tested (yes/no/don't care).
  284.  
  285. *****************************************************************************
  286.  
  287.                     Updates, Version 2.86 - 29/04/91
  288.  
  289.   Having played with Impression and found many of the bugs (the rest presumed
  290. to exist only when you're not going to immediately notice) I thought :
  291.   'Hey, those shaded icons and the icons that change the pointer shape really
  292. do look crap !'  However, another anonymous accomplice of mine disagreed, but
  293. that's just the way he is, so he adjusted his copy of v2.85 to support this
  294. 'Interface' module he'd just acquired - which does all of the Impression-type
  295. junk for you.
  296.   I took one look and said 'NO, NO, NO' a few times, but then took up his
  297. idea of using the MessageTrans module - so now refer to the 'Messages' dir.
  298. inside FormEd.
  299.   Following that, I decided to support 'Interface' - as a user-configurable
  300. option. Hence on the 'Options' dialogue box you will now see the extra
  301. 'Support Interface' and 'Shade user-redrawn templates' icons. (The latter is
  302. present because Interface uses user-redraws to do it's icon borders, so
  303. normally you will have one OR the other selected.)
  304.   In addition, the country name can be changed so that a different 'Messages'
  305. file is used - it is just the name of a file inside that directory. For demo
  306. purposes, I also include a 'Sarcasm' country - for users with a superiority
  307. complex.
  308.   There is also a teensy bug fix - your choices in the (de)select dialogue
  309. boxes remain intact, ie are not cleared to the default 'Any, Any, Don't Care,
  310. Don't Care' set-up. This does not change the effect of choosing (De)Select
  311. without using the dialogue boxes.
  312.  
  313. *****************************************************************************
  314.  
  315.                     Updates, Version 2.87 - 23/06/91
  316.  
  317.   Good grief, it's been a long time since the last one...perhaps I've been
  318. doing some 'real' work for a change...??
  319.   No bug fixes, 'cos I haven't found the bugs !!!
  320.  
  321.   OPTIONS: A new error message for when you choose a non-existant country.
  322.            As before, it chooses 'UK' for you, but it tells you of your error
  323.            in the previous language (for continental users rather than for
  324.            Britons who piss about)
  325.     MENUS: The two main menus ('Window' and 'Icons') re-open properly when
  326.            you open one, move it and open the other (it used to open where
  327.            you'd opened the first one)
  328. TEMPLATES: When FormEd loads, a window in the top-left called 'Templates'
  329.            opens up listing all of the templates loaded. Double-clicking on
  330.            a template name toggles its opened/closed state (ie. it will close
  331.            an opened window and open a closed one.) SHIFT-double-clicking
  332.            opens the appropriate window 'on top'.
  333.            A menu from this window (á la Filer) allows you further control
  334.            over opening/closing, plus facilities for copy, renaming and
  335.            wiping. By the way, don't be surprised if COPY doesn't seem to be
  336.            working correctly - it SHOULDN'T work, but it seems to !!
  337.            The 'Templates' submenu from the icon bar menu tree is now reached
  338.            from this window too. (Create, Clear, Load, Save). The biggest
  339.            benefit of this is that the screen does not get so cluttered !!
  340.            Rabbit should be pleased, he's got absolutely HUGE template files.
  341.            NOTE : closing a template no longer removes it from memory !!!
  342.   HANDLES: A useful utility which displays a small window in the top-right of
  343.            the screen which tells you which template the pointer is over, and
  344.            (if any) what icon number. Most handy for looking over 'imported'
  345.            templates.
  346.      SHOW: Both 'Templates' and 'Handles' windows can be opened via the icon
  347.            bar menu, and the 'Show' submenu.
  348. WORK AREA: The 'set work area' window has an extra option, 'Min'. Choosing
  349.            this sets the work area to be equivalent to the visible area. This
  350.            bypasses the previous practice of setting the values out of range
  351.            via the keyboard, then using the arrows to set the values to their
  352.            minimum settings.
  353.  MOUSEFIX: Owners of the superb 'Mouse Fixer' module may wish to note that
  354.            FormEd now sets the MouseFix variables MinSpeed, Acceleration and
  355.            FrameCount to 1, 16 and 4 respectively. This means that delicate
  356.            mouse control (moving and resizing) can easily be effected.
  357.            NOTE: 'FrameCount' is not available in MouseFix 0.02
  358.  
  359. *****************************************************************************
  360.  
  361.   For those interested, here's Acorn's crap on the subject, as found in my
  362. application directory. Anything subsequently in this text file is unedited,
  363. excepting the last few lines (blanks and asterisks).
  364.  
  365. *****************************************************************************
  366.  
  367. Notes on using FormEd, 16-May-89
  368.  
  369. FormEd is an editor of Template files. To understand this you need to
  370. understand the program interface of the Window System, as described in the
  371. Programmer's Reference Manual. The description here assumes an understanding
  372. of template files.
  373.  
  374. FormEd is started by double-clicking on a template file after the FormEd
  375. icon has been "seen". This will cause FormEd to be loaded, and to display
  376. all of the windows in the template file. Alternatively, double-click on
  377. FormEd itself and it will be loaded with no current windows. If a template
  378. file does not appear to load properly, give more memory to FormEd before it
  379. starts using the Task Manager window.
  380.  
  381. A template file is often constructed with reference to a specific set of
  382. sprites. A sprite file can be dragged onto the FormEd icon on the icon bar
  383. to set the available sprites. These are displayed in a window. Some previous
  384. versions of FormEd used to provide facilities for editing sprites, these are
  385. now provided only in the Paint application.
  386.  
  387. Clicking on the FormEd icon creates a new window in the current template
  388. file, and displays it on the screen.
  389.  
  390. The menu provided from the icon on the icon bar provides the following
  391. functions:
  392.  
  393. Create window - similar to clicking on the FormEd icon, except that a name
  394. may be specified for the template.
  395.  
  396. Load templates - allows you to type in the filename of a template file to be
  397. loaded, instead of dragging an icon from the Filer.
  398.  
  399. Save templates - a save box for the templates being edited.
  400.  
  401. Quit - quit FormEd. Beware that this has no "confirm" option, so any edits
  402. will be discarded instantly if you choose this menu entry.
  403.  
  404. The template windows displayed by FormEd mirror precisely the size, position
  405. and properties of the windows in the Template file. The following actions
  406. directly affect the stored values:
  407.  
  408. Close the window - deletes it from the template file.
  409.  
  410. Move/scroll/resize the window - moves the default setup of the window in the
  411. template file.
  412.  
  413. Clicking MENU on a template window produces a menu tree that allows a wide
  414. variety of alterations to the menu structure, based on the various control
  415. fields of a window structure as described in the Wimp documentation. It also
  416. allows you to create icons in the window. An icon, once created, can be
  417. moved and resized using drag-SELECT and drag-ADJUST. It can also have its
  418. properties adjusted by pointing at it and then clicking MENU, and following
  419. the "amend icon" submenu.
  420.  
  421. The best way to experiment is to examine and update the template files
  422. belonging to the Applications Suite (saving the original first!). It's also
  423. possible to update the template files used by ROM utilities. These reside in
  424. the deskfs: filing system in the ROM. They are accessed via the environment
  425. variable Wimp$Path, so by updating this to search a directory of your own
  426. first where your updated template files reside, you can replace the window
  427. templates used by the utilities in the ROM.
  428.  
  429. Your ability to drag and resize icons may be affected by a button type
  430. affixed to an icon: only those button types which generate the appropriate
  431. Wimp events can be dragged and resized directly. It's interesting to note
  432. that FormEd keeps no data structures describing each template window,
  433. relying on the Wimp to keep and manipulate each structure.
  434.  
  435. FormEd keeps a file of sprites in memory which can be used in icons in the
  436. template being edited. The default sprite file used is the file Default
  437. inside !FormEd, which is in fact a copy of the sprites found in the RISC OS
  438. ROM. To load in a separate sprite file to use with your template file, drag
  439. the sprite file onto the FormEd icon.
  440.  
  441. *****************************************************************************
  442.  
  443.